-----------------------------------------------------------------------------

                        T G A S C A L E   1 . 1 a
                      _____________________________
                      ~^~^~^~^~^~^~^~^~^~^~^~^~^~^~

Copyright (c) 1993 by TBH-Softworx --- all rights reserved
              Oliver Fromme, Klingestr. 2, 3380 Goslar, Germany
                      (nach dem 1.7.1993: 38640 Goslar, Germany)
              Internet e-mail: inof@asterix.rz.tu-clausthal.de


Dieses Programm ist Teil des JPGIndex-Paketes. Alle dort angegebenen
Copyright-, Benutzungs- und Weitergabebestimmungen haben auch fr dieses
Programm Gltigkeit, ebenso die Sicherheitshinweise.

-----------------------------------------------------------------------------

TGAWrite wird von JPGIndex verwendet (bzw. von der Batch-Datei, die von
JPGIndex erzeugt wird). Dazu muá man nicht wissen, wie TGAWrite funktioniert.
Wenn Sie nur JPGIndex verwenden m”chten, k”nnen Sie diese Dokumentation
berspringen (es gengt, wenn Sie JPGINDEX.DOK lesen).

TGAWrite dient dazu, eine Text in ein Targa-Bild zu schreiben. In der
vorliegenden Version ist nur weiáer Text auf schwarzem Hintergrund m”glich,
und zwar in der 8x8-Standardschrift. Der Text kann von links nach rechts oder
(um 90 gegen den Uhrzeigersinn gedreht) von unten nach oben dargestellt
werden. (Die in der Planung befindliche n„chste Version wird auch farbig
beschriften und andere Zeichens„tze untersttzen k”nnen. Ein komfortabler
Zeichensatzeditor, der auch fr normale Textmodus-Zeichens„tze verwendet
werden kann, existiert bereits.)

Es wird empfohlen, das zu beschriftende Bild auf einer gengend groáen
RAM-Disk zu bearbeiten, da auf die Ausgabedatei in verst„rktem Maáe
nicht-linear zugegriffen wird.

Syntax:
   TGAWRITE <targafile> <x> <y> <direction> <text>
oder:
   TGAWRITE <targafile> @<script>

Keiner der Parameter darf weggelassen werden, und sie mssen in der hier
angegebenen Reihenfolge stehen! Ihre Bedeutung im einzelnen:

<targafile> ist das zu beschriftende Targa-Bild (Graustufen- oder Farbbild).
            Im Gegensatz zu den meisten anderen Targa-Tools gibt es hier
            keine Ein- und Ausgabedatei, sondern es wird die angegebene
            Datei direkt ver„ndert. Man sollte also vorher eine Kopie davon
            machen, falls man das unbeschriftete Bild hinterher noch braucht.

<x> <y>     legen die linke obere Ecke fest, an der der Text positioniert
            werden soll. Wenn man von unten nach oben schreibt, ist es die
            linke obere Ecke aus der Sicht des Bildes (die rechte obere Ecke
            aus der Sicht der Textes).

<direction> Entweder "R" (left-Right), um den Text von links nach rechts zu
            schreiben, oder "U" (bottom-Up), um den Text von unten nach oben
            zu schreiben.

<text>      ist der zu schreibende Text. Er darf auch Lerrzeichen enthalten,
            allerdings werden mehrere Leerzeichen hintereinander zu einem
            einzelnen Leerzeichen zusammengefaát. Spezialzeichen von DOS
            (im wesentlichen "<", ">" und "|") sind nicht erlaubt!

<script>    Name einer Textdatei, die die Daten fr die Beschriftung enth„lt.
            Jede Zeile in diesr Datei muá den folgenden Aufbau haben
            (Leerzeilen werden ignoriert):
               <x> <y> <direction> <text>
            Hierbei darf der <text> auch die o.g. Sonderzeichen enthalten.
            Mehrfache Leerzeichen werden nicht zusammengefaát. Es sind
            beliebig viele Zeilen mit Beschriftungsdaten erlaubt.

Man sollte darauf achten, daá jeder Text auch ganz in das Targa-Bild paát.
Sollte der Text ber eine der Bildgrenzen hinausragen, bricht TGAWrite mit
einer entsprechenden Fehlermeldung ab.

-----------------------------------------------------------------------------

Allgemeine Hinweise zu den Targa-Tools findet man in der Datei
JPGINDEX.DOK.

Per aspera ad astra!
      - Olli -

-----------------------------------------------------------------------------
Oliver Fromme, Klingestr. 2, 3380 Goslar, Germany
        (nach dem 1.7.1993: 38640 Goslar, Germany)
Internet email: inof@asterix.rz.tu-clausthal.de
-----------------------------------------------------------------------------
Ein kostspieliger Chip, geschtzt durch eine schnell wirkende Sicherung,
wird die Sicherung schtzen, indem er zuerst durchbrennt.
   (Erstes Murphy'sches Bauteilegesetz)